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FIG. 8 

1 /* collection data structure */ 

2 collection-info { 

3 + specifierjnfo 

4 + coil-type-indicator 

5 + other specifier information . . . 

6 + contentjnfo 

7 + content Jocationjnfo . . . 

8 + content_members ... 

9 + other content information . . . 

10 + other collection structure information... 

11 } 



FIG. 9 

1 /* collection type definition data structure */ 

2 collection-type-definition-info { 

3 + coil-type-name 

4 + collection internal structure info ... 

5 + collection content location info ... 

6 + collection content type recognition info ... 

7 + other collection type definition information... 

8 } 
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FIG. 10 



KEY 
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1 /* collection type internal structure definitions */ 

2 dir_source_files ./s 

3 dir doc files ./doc 



4 /* content location definitions (per-type content links) 7 

5 content_subtree_http http://host.com/some/dir/name 

6 content_subtree_ftp ftp://host.com/some/dir/name 

7 content_subtree_nfs /some/local/directory/name 

8 /* content type recognition definitions */ 



9 content_policy 

1 0 content_file_type 

1 1 content_file_type 

1 2 content_f ile_type 

13 content_file_type 

14 content_fileJype 

15 content_fileJype 



subtree_below_cspec_file 

.c file_cpp 

.c file_c 

.h file_cjnclude 

.doc file_ms_word 

.html file^html 

.xls file ms excel 



16 /* collection processing definitions */ 



17 compile_c_files 

18 compiler_windows 

19 compiler_unix 

20 build platforms 

21 process files 

22 link libraries 



yes 

VC++ 

gcc 

Win98, Win2000, gnulinux 
compile link 
stdio math sock 



23 /* results dispatching definitions 7 

24 results_ftp_host ftp.output.com 

25 results_ftp_dir c:\ftphome\collection\results 
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FIG. 12 

1 /* simplified algorithm for collection makefile generator */ 

2 Call get runtime info to get invocation parameters 

3 Call collection content classifier to classify collection content 

4 Call collection makefile generator manager to generate 

a complete makefile, passing classifier information as input 



7/41 



130 



COLLECTION 
MAKEFILE 
MANAGER 



FIG. 13 



PROCESS 
COLLECTION 
SVCS 



131 



SORT 
PRODUCT 
BUILD ORDERS 



\ 



134 



CALC COLL 
PARALLEL 
TARGETS 



\ 



135 



PRODUCT 
MAKEFILE 
MANAGER 



\ 



140 



DO COLL 
TYPE DEF 
SVCS 



V 



132 



133 



DO COLL 
STANDALONE 
SVCS 



FIG. 14 

1 /* simplified algorithm for collection makefile manager */ 

2 Process collection-level fragments 

3 Process fragments from collection type definition 

4 Process fragments from collection specifier 

5 Determine relative build order among multiple products 

6 Determine number, names of coll-level parallel build targets 

7 Loop over each product in collection 

8 Process each product by calling product makefile manager 
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FIG. 15 
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FIG. 16 

1 /* simplified algorithm for processing one product */ 

2 Process product-level fragments 

3 Process fragments from product type definition 

4 Process fragments from product section of collection specifier 

5 Determine relative build order among content files for product 

6 Determine number, names of product-level parallel build targets 

7 Loop over each content file 

8 Process each content file by calling file makefile manager 
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FIG. 18 

1 /* simplified algorithm for processing one content file */ 

2 Calculate include file search directories 

3 Process fragments from content type definition 

4 Process fragments from action type definition 
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FIG. 20 



1 /* simplified algorithm for processing one fragment */ 

2 Substitute replacement values for placeholder strings 

3 Insert substituted fragment into makefile data structure 
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FIG. 21 

1 c:\collections 



2 c-my-example 

3 cspec 

4 s 

5 pi 

6 cmdiine.h 

7 win98 

8 cmdiine.c 

9 gnulinux2 

10 cmdiine.c 

11 lib 

12 pi 

13 libfuns.h 

14 libfuns.c 



FIG. 22 

1 cspec: 

2 collection c-my-example 

3 coll-type ct-program 

4 coll-desc A multi-platform C program with library. 

5 end-collection 

6 product myprog 

7 prod-type pt-program 

8 prod-desc A program product. 

9 libs team-lib gnulinux-lib 

1 0 end-product 

1 1 product mylibrary 

12 prod-type pt-library 

13 prod-desc A library product. 

14 end-product 
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FIG. 23 

1 /* classification output for gnulinux2 platform */ 

2 collection c-my-example 

3 coil-type ct-program 

4 ... other coll classification info 



5 


/* classification info for a program product */ 


6 


product 


myprog 


7 


prod-type 


pt-program 


8 


content 


cmdiine.h 


9 


content-path 


../s/pi/cmdiine.h 


10 


content-type 


ctype-c-header 


11 


content-language 


c 


12 


end-content 




13 


content 


cmdiine.c 


14 


content-path 


../s/gnulinux2/cmdline. 


15 


content-type 


ctype-c-source 


16 


content-language 


c 


17 


content-dep 


../s/pi/cmdIine.h 


18 


content-dep 


../lib/pi/libfuns.h 


19 


content-dep 


external-inci-file.h 


20 


content-dep 


team-incl.h 


21 


end-content 




22 


end-product 
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FIG. 24 



1 


/* classification output */ 


2 


collection 


c-my-example 


3 


... /* classification info for the host collection */ 


4 


... /* classification info for the program product */ 


5 


/* classification info for a library product */ 


6 


product 


mylibrary 


7 


prod-type 


pt-library 


10 


content 


libfuns.h 


11 


content-path 


../lib/pi/libfuns.h 


12 


content-type 


ctype-c-header 


13 


content-language 


c 


15 


end-content 
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libfuns.c 


17 


content-path 


../lib/pi/cmdiine.c 


18 


content-type 


ctype-c-source 


19 


content-language 


c 


21 


content-dep 


../lib/pi/libfuns.h 


22 


end-content 




23 


end-product 
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FIG. 25 

1 collection type definition information 

2 product type definition information 

3 content type definition information 

4 action type definition information 



5 cspec: 

6 coll-type 

7 index-coll-types.tbl: 

8 ct-program 

9 ct-web-page 

10 ct-program.def: 

1 1 product-type-index 

1 2 index-product-types.tbl 

13 pt-program 

14 pt-program. def: 

1 5 content-type-index 

1 6 index-content-types.tbl 

17 ctype-c-source 

18 content-c.def: 

1 9 action-type-index 

20 index-action-types.def: 

21 action-c-source 

22 action-c-source.def: 

23 ... action definition information 



ct-program 

ct-program.def 
ct-web-page.def 

index-product-types.tbl 

pt-program. def 

index-content-types.tbl 

content-c.def 

index-action-types.tbl 

action-c-source.def 
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FIG. 26 
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6 


/* type definition info for a 


"ct-program" collection type */ 




7 


product-type-index 


index-prod-program. tbi 


fTI 


8 


base-template 


base-template.tpl 




9 


service 


svc-coii-macro-platform 




10 


service 


svc-coll-macro-site 




11 


service 


svc-coll-macro-tool-names 




12 


service 


svc-coll-macro-compiler 


fi 


13 


service 


svc-coll-macro-suffix 




14 


service 


svc-coll-target-defaults 




15 


service 


svc-coll-target-others 


!™ 


16 


parallelism-max 


4 




17 


... other collection type info 



16/41 



FIG. 27 



1 index-prod-program.tbl: 

2 pt-program 

3 pt-program-java 

4 pt-program-unix 

5 pt-program-win 



pt-program.def 
pt-program-java. def 
pt-program-unix.def 
pt-program-win.def 



6 
7 
8 
9 
10 
11 
12 
13 
14 



pt-program.def: 

/* type definition info for a "program" product type 7 



dir-source-files 
dir-library-files 
dir-include-files 
file-identification-table 
content-type-index 
service 

... other product type info 



dirs-source.lst 

dirs-library.lst 

dirs-include.lst 

file-identification.tbl 

index-content-types.tbl 

svc-prod-program 



1 

2 
3 
4 
5 

6 
7 
8 
9 
10 
11 
12 
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FIG. 28 

index-content-types.tbl: 

ctype-c-source 

ctype-c-header 

ctype-csh 

ctype-html 



content-c.def 
content-c-h.def 
content-csh.def 
content-html.def 



content-c.def: 

/* type definition info for a "c" file type 
type 

language 
action 

action-type-index 
service 



*/ 



c-source 
c 

action-c-source 
index-action-types.tbl 
svc-file-c-source 



13 ... other content type definition info 
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1 index-action-types.tbl: 

2 action-c-source 

3 action-c-header 

4 action-csh 

5 action-html 



action-c-source.def 
action-c-header.def 
action-csh. def 
action-html. def 



6 action-c-source.def: 

7 parser-type 

8 parser-name 

9 service 



internal 
internal-c 

svc-action-c-source 
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FIG. 30 

1 idx-makefile-services.tbl: 

2 /* services for collections */ 

3 svc-coll-macro-platform coll-macro-platform.tpl 

4 svc-coll-macro-site coll-macro-site.tpl 

5 svc-coll-macro-compiler coll-macro-compiler.tpl 

6 svc-coll-macro-toolnames coll-macro-toolnames.tpl 

7 svc-coll-macro-file-suffix coll-macro-file-suffix.tpl 

8 svc-coll-target-defaults coll-target-defaults.tpl 

9 ... 

1 0 /* services for products */ 

prod_prog_pi.tpl 
prod_prog_os.tpl 
prod_prog_pd.tpl 

prod-lib-pi.tpl 
prod-lib-os.tpl 
prod-lib-pd.tpl 



file-c.tpl 

file-c-header.tpl 
file-f90.tpl 
file-f90-header.tpl 
file-f90-module.tpl 



action-c-source.tpl 

29 /* services for application tasks */ 

30 svc-app-chmod app-chmod.tpl 

31 svc-app-copy-file app-copy-file.tpl 

32 ... 
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svc-prod-program 
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svc-prod-program 
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svc-prod-program 


f-J 


14 






15 


svc-prod-library 




16 


svc-prod-library 




17 


svc-prod-library 




18 






19 


/* services for files */ 


11 1 


20 


svc-file-c-source 




21 


svc-file-c-header 




22 


svc-file-f90 




23 


svc-file-f90-header 




24 


svc-file-f90-module 




25 






26 


/* services for actions */ 




, 27 


svc-action-c-source 
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FIG. 31 

1 coll-macro-platform.tpl: 

2 # This file defines platform-specific makefile macros 
3 

4 fragment-begin 

5 _marker_ marker-htree copy 

6 # Tlie holding area for shared files and libraries 

7 HTREE=/site/h 

8 fragment-end 
9 

10 fragment-begin 

11 _marker_ marker-macrosi copy 

12 # makefile platform name, virtual platform name 

13 MP=win98.plt 

14 VP=win98 

15 fragment-end 



FIG. 32 

1 coll-macro-site.tpl: 

2 # This file defines site-specific makefile macros 

3 fragment-begin 

4 _marker_ marker-macros 1 copy 
5 

6 # places where shared files go 

7 SHARE_DIR=${HTREE)\share 
8 

9 # places where web pages go 

10 HOST_WEB=www. your_domain.com 

11 ... 

12 fragment-end 
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FIG. 33 

1 coll-macro-toolnames.tpl: 

2 # define macros for various program names 

3 fragment-begin 

4 _marl<er_ marker-macros 1 copy 
5 

6 LS=ls 

7 DIR=dlr 

8 RM=rm 

9 CP=cp 

10 ZIP=zip 

1 1 UNZIP=unzip 

12 CC=gcc 

13 LIB=ld 

14 RMDIR=nn 

15 fragment-end 



FIG. 34 

1 coll-macro-compiler.tpl: 

2 # This file defines compiler options 

3 fragment-begin 

4 _marker_ marker-macrosi copy 
5 

6 # default compiler options 

7 OPT= 

8 DEBUG= 

9 # default linker options 

1 0 LIBSPATH = $(HTREE)/$(MP) 

1 1 LDFLAGS= -s 

12 LPP=-L 
13 

14 fragment-end 
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FIG. 35 

1 coll-macro-suffix.tpl: 

2 # defines macros for file suffixes for this platform 

3 fragment-begin 

4 _marker_ marl<er-macros1 copy 
5 

6 # objects, executables, libraries, archives 

7 0=.o 

8 SO=.so 

9 X= 

10 L=a 

11 A= 

12 AWKS=.awk 

13 SEDS=.sed 

14 LEXS=.I 

15 YACS=.y 

16 CLASS=.class 

17 fragment-end 

FIG. 36 

1 coll-target-defaults.tpl: 

2 # This file defines default makefile targets 

3 fragment-begin 

4 _marker__ marker-targetsO copy 
5 

6 # default targets used by all makefiles 

7 default: build 
8 

9 all: build exports 
10 

11 build: 
12 

13 exports: 

14 fragment-end 
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FIG. 37 

0 /* fragment commands */ 

1 fragment-begin / fragment-end 

2 _marker_ marker-name copy 

3 _macro_ macro-name append valuel value2. 

4 _target_ target-name add-deps dep1dep2... 

5 _target_ target-name copy 

6 _target_ target-name copy-force 



FIG. 38 

1 base-template.tpl: 
2 

3 # marker-htree 
4 

5 # marker-macros 1 
6 

7 # marker-targetsO 
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FIG. 39 





1 


makefile out* 




2 






3 






4 


HTREE=/site/h 




5 


# markpr-htrpp 

TT 1 1 ICII 1 III WW 




6 






7 


# makpfilp niatfnrm namp v/irtual niatfnrm namp 




8 


MP=winQ8 nit 

ivin vviii^u.L^ii 




9 


\/P=win98 

V i Vv II 1 w \J 




10 




: f% 


11 


it nlapp^ \A/hprp ^harpH filpQ nn 

TT |k^lCIV/CO VVI Iwl w Ol ICII 1 llwO Mw 


§^ 


12 


SHARE DIR=$fHTREEHshare 

\J\ L^IIX y^\l i 1 Ix^^yvOIICilw 


w 


13 




I rl 


14 


LS=!s 




15 


DIR=dir 


'•Z. ! 


16 






17 


OPT= 




18 


DEBUG= 




19 






20 


0=.o 




21 


SO=.so 


!^ 


22 


X= 




23 






24 


# marker-macrosi 




25 






26 


# default targets used by all makefiles 




27 


default: build 




28 






29 


all: build exports 




30 






31 


build: 




32 






33 


exports: 




34 


# marker-targetsO 
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FIG. 40 

1 prod-prog-pi. tpl: 

2 # Define platform-independent macros for programs 
3 

4 fragment-begin 

5 _marker_ marker-macros 1 copy 

6 # Initialize these macros so they are defined. 

7 ALL_OBJS_prod_= 

8 OBJ_PI _prod_= 

9 OBJ_F90 prod_= 

10 OBJ_F90_MOD_prod_= 
11 

12 # create one macro to hold all objects 

13 ALL_OBJS_prod_=$(OBJ_PI_prodJ \ 

14 $(OBJ_F90_prodJ $(OBJ_F90_MOD_prodJ 
15 

16 # add marker to anchor linker macro later 

17 # marker-link-cmd 

18 fragment-end 



FIG. 41 

1 prod-prog-os.tpl: 

2 # Define operating system macros for programs 
3 

4 # Adds program name dependency to build target. 

5 fragment-begin 

6 _target_ build add_deps _mprod_$(X) 

7 fragment-end 
8 

9 # Adds program name dependency to export target 

10 fragment-begin 

1 1 _target_ exports add_deps _mprod_$(X) 

12 fragment-end 
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FIG. 42 

1 prod-prog-pd.tpl: 

2 # Define platform-dependent macros for programs 
3 

4 fragment-begin 

5 _marker_ marker-macros 1 copy 

6 # default compiler flags for this platform 

7 CCFLAGS1 = -Wall -ansi -pipe -I. 

8 CCFLAGS2=-l--c 

9 fragment-end 
10 

1 1 fragment-begin 

1 2 _marker_ marker-link-cmd copy 

1 3 # linker command for this platform 

14 LDLIBS= 

1 5 LD prod_=${CC} -o _mprod lib_dirs_ \ 

16 $(ALL_OBJS_prodJ Jib_names_ 

17 fragment-end 
18 

19 fragment-begin 

20 # add link command to target for program product 

21 _target mprod_$(X) copy 

22 $(LD_prodJ $(LDFLAGS) 

23 $(CHMOD) 775 _mprod_$(X) 

24 fragment-end 
25 

26 fragment-begin 

27 # add object dependencies to product target 

28 Jarget_ _mprod_$(X) add_deps $(OBJ_PI prod J 

29 fragment-end 
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FIG. 43 



1 _prod_ 

2 _mprod_ 

3 _ptype_ 

4 _src_file_path_ 

5 _src_file_name_ 

6 _src_file_name_no_suf_ 

7 _targetjist_ 

8 _target_name_ 

9 _deplist_ 

10 Jncl_dirs_ 

1 1 Jib_dirs_ 

12 Jib_names_ 

13 _zpln_ 



name of product from cspec 

name of product file on disk 

product type of current product 

source file pathname 

source file filename 

source filename with no suffix 

list of makefile targets 

name of current target 

list of dependent targets 

list of include directories 

list of library directories 

list of library names 

parallel target number 01,02,etc 
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FIG. 44 

1 makefile. out: 

2 ... 

3 # Initialize these macros so they are defined. 

4 ALL_OBJS_myprog= 

5 OBJ_PI_myprog= 

6 OBJ_F90_myprog= 

7 OBJ_F90_MOD_myprog= 
8 

9 # create one macro to hold all objects 

1 0 ALL_OB JS_myprog=$(OB J_PI_myprog) \ 

1 1 $(OBJ_F90_myprog) $(OBJ_F90_MOD_myprog) 
12 

1 3 # marker-link-cmd 
14 

1 5 # marker-macrosl 
16 

17 # default targets used by all makefiles 

18 default: build 
19 

20 all: build exports 
21 

22 build: myprog 
23 

24 exports: myprog 

25 # marker-targetsO 



• 



28/41 



FIG. 45 

1 makefile.out: 

2 ... 

3 # Initialize these macros so they are defined. 

4 ALL_OBJS_myprog= 

5 OBJ_PI_myprog= 

6 ... 

7 # create one macro to hold all objects 

8 ALL_OBJS_myprog=$(OBJ_PI_myprog) ... 

9 ... 

10 # linker command for this platform 

11 LDLIBS= 

12 LD_myprog=${CC} -0 myprog $(LDLIBS) \ 

13 $(ALL_OBJS_myprog) $(lb) 

14 # marker-link-cmd 

15 ... 

16 # default compiler flags for this platform 

1 7 CCFLAGS1 = -Wall -ansi -pipe -I. 

18 CCFLAGS2= -I- -c 

19 # marker-macrosi 

20 ... 

21 build: myprog 
22 

23 exports: myprog 

24 ... 

25 # add link command to target for program product 

26 myprog: $(OBJ_PI_myprog) 

27 $(LD_myprog) $(LDFLAGS) 

28 $(CHMOD) 775 myprog 

29 # marker-targetsO 
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FIG. 46 

1 file-c-source.tpl: 

2 # process files 
3 

4 # add current source file to top src file macro 

5 fragment-begin 

6 _macro_ SRC_C append _src_file_path_ 

7 fragment-end 
8 

9 # add current source file to product source file macro 

10 fragment-begin 

1 1 _macro_ SRC_C prod_ append _srcjile_path_ 

12 fragment-end 



FIG. 47 

1 action-c-source.tpl: 

2 # process files 
3 

4 # add compilation command under C object targets. 

5 fragment-begin 

6 _target_ Jarget_name_$(0) copy 

7 $(CC) $(OPT) $(DEBUG) $(CCFLAGS1 ) \ 

8 Jncl_dirs_ $(CCFLAGS2) _src_file_path_ 

9 fragment-end 
10 

1 1 # add dependency list to C object target. 

12 fragment-begin 

1 3 _target_ Jarget_name_$(0) add_deps _deplist_ 

14 fragment-end 
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FIG. 48 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 



makefile, out: 

SRC_C= ../s/gnulinux2/cmdline.c ... 
SRC_C_procl_= ../s/gnulinux2/cmdline.c ... 

# default compiler flags for this platform 
CCFLAGS1= -Wall -ansi -pipe -I. 
CCFLAGS2= -I- -c 

# marker-macrosi 

# default targets used by all makefiles 
default: build 

all: build exports 

build: myprog 

exports: myprog 

cmdiine.o: ../s/pi/cmdiine.h ../lib/pi/libfuns.h 
$(CC) $(OPT) $(DEBUG) $(CCFLAGS1) \ 

_incl_dirs_ $(CCFLAGS2) ../s/gnulinux2/cmdline. 



# marker-targetsO 




1 


collection 


2 


coll-type 


3 


coll-desc 


4 


SVC 


5 


end-collection 


6 


product 


7 


prod-type 


8 


libs 


9 


SVC 


10 


end-product 
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FIG. 49 

c-my-example 

ct-program 

A fileset example 

svc-coll-cleanup 



myprog 

pt-program 

mylib 

svc-app-copy-file 




myprog myprog. bak 
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FIG. 50 



1 

2 



cspec: 



3 
4 
5 
6 

7 
8 
9 
10 
11 



product 
prod-type 
prod-desc 
end-product 



myprog 
pt-program 

A normal program binary executable. 



product 
prod-type 
prod-desc 
replace-name myprog 
end-product 



myprog-2 
pt-shared-object 

A shared object program executable 



12 _prod_ becomes cspec name myprog-so 

13 _mprod_ becomes diskfile name myprog 

14 # add link command to target for program product 

15 _mprod_$(X): 

16 $(LD_prodJ $(LDFLAGSjDrod J 

1 7 $(CHMOD) 775 _mprod_$(X) 



1 8 # link target for product myprog 

19 myprog$(X): 

20 $(LD_myprog) $(LDFLAGS_myprog) 

21 $(CHMOD) 775 myprog$(X) 



22 # link target for product myprog-so 

23 myprog$(SO): 

24 $(LD_myprog-2) $(LDFLAGS_myprog-2) 

25 $(CHMOD) 775 myprog$(SO) 
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FIG. 51 



1 


product-build-order.tbl: 


2 
3 


# define relative build order among products 


4 


pt-initial 


10 


5 


pt-data 


50 


6 


pt-library 


100 


7 


pt-program 


1000 


8 


pt-script 


1000 



FIG. 52 

1 makefile.out: 

2 ... 

3 # dependent targets mylib and myprog appear in proper 

4 # product build order, from left to right 

5 # 

6 build: mylib myprog 
7 

8 mylib: 

9 ... 

10 myprog: 
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FIG. 53 

1 file-build-order.tbl: 

2 # define relative build order among file types 
3 

4 ft-resource 10 

5 ft-precompiled-cpp 20 

6 ft-c-source 50 



FIG. 54 

1 makefile.out: 

2 ... 

3 # dependent targets mylib and myprog appear in proper 

4 # product build order, from left to right 

5 # 

6 build: mylib myprog 
7 

8 mylib: 

9 ... 

10 myprog: myresource.rc myprecompiled-header.o cmdiine.o 




• 
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FIG. 55 



dirs-include.lst: 



dir/gnulinux2 
dir/gnulinux2 
dir/gnulinux2 
dir/gnulinux2 



/site/myteam/include/gnulinux2 
/site/myteam/include/gnulinux 
/site/include/gnulinux2 
/site/include/gnulinux 



FIG. 56 



# suppose these are paths to example include files 
/site/include/gnulinux2/external-incl-file.h 
/site/myteam/include/gnulinux/team-incl.h 

# include files matched by search rules, in order 
/site/myteam/include/gnulinux/team-incl.h 
/site/include/gnulinux2/externai-incl-file.h 

JncLdirs_ = -I /site/myteam/include/gnulinux \ 



$(CC) $(OPT) $(DEBUG) $(CCFLAGS1) \ 

-I /site/myteam/include/gnulinux -I /site/include/inux2 \ 

$(CCFLAGS2) ../s/file1.c 



... -I /site/include/inux2 



makefile. out: 



filel.o: ../s/file1.c 



• # 
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FIG. 57 



/site/myteam/lib/gnulinux2 
/site/myteam/lib/gnulinux 
/site/lib/gnulinux2 
/site/lib/gnulinux 



FIG. 58 

1 # suppose these are paths to example libraries 

2 /site/lib/gnulinux2/gnulinux-lib.a 

3 /site/myteam/lib/gnulinux/team-lib.a 

4 # libs matched by search rules, in order 

5 /site/myteam/lib/gnulinux/team-lib.a 

6 /site/lib/gnulinux2/gnulinux-lib.a 

7 _lib_dirs = -L /site/myteam/lib/gnulinux -L /site/lib/inux2 

8 Jib_names_ = -I team-lib.a gnulinux-lib.a 

9 makefile. out: 

10 ... 

1 1 LD_mprog = $(LD) -L /site/myteam/lib/gnulinux \ 

12 ... -L /site/lib/gnulinux2 \ 

13 ... -I team-lib.a -I gnulinux-lib.a 

14 ... 

15 myprog$(X): ... 

16 $(LD_mprog) ... 



1 dirs-library.lst: 

2 dir/gnulinux2 

3 dir/gnulinux2 

4 dir/gnulinux2 

5 dir/gnulinux2 



• 
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FIG. 59 



1 


virtual-platform.tbl: 


2 


# 




3 


# 


Specific 


4 


# Name 


OS 


5 


# 




6 


gnulinux2.plt 


gnulinux2 


7 


sol28.plt 


SOI28 


8 


win98.plt 


win98 


9 


win95.plt 


win95 


10 


winnt40.plt 


winnt40 


11 


win2000.plt 


win2000 



Generic 


Family 


Every 


OS 


OS 


OS 


gnulinux 


Unix 


pi 


sol 


Unix 


pi 


win9 


win 


pi 


win9 


win 


pi 


winnt 


win 


pi 


winnt 


win 


pi 



FIG. 60 



1 # fragment search directories for win98 platform 

2 fragments/win98 

3 fragments/win9 

4 fragments/win 

5 fragments/pi 

6 # fragment search directories for gnulinux 2 platform 

7 fragments/gnulinux2 

8 fragments/gnulinux 

9 fragments/unix 
10 fragments/pi 
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FIG. 61 



1 collection 

2 coll-type 

3 coll-desc 

4 end-collection 



c-my-example 

ct-program 

A fileset example 



5 product 

6 prod-type 

7 libs/pi 

8 libs/gnulinux 



9 

10 
11 
12 



svc/pi 

svc/gnulinux 

svc/win98 

end-product 



myprog 
pt-program 

mylib 

mylib myother-gnulinux-lib 



svc-prod-name 
svc-prod-name 
svc-prod-name 



SVC arguments 
SVC args 
SVC args 



# 
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FIG. 62 



1 

2 
3 
4 



myprog: file-001.ofile-002.o ... file-100.o 
$(LD_mprog) ... 



makefile.out 



5 # GNU make parallelism with -jobs argument will compile 

6 #4 files at a time to build the myprog target 

7 # 

8 make -j 4 myprog 

9 # without a parallel make tool, makefile targets must be 

1 0 # generated to offer parallelism, as follows: 

11 # 

12 myprog: myprog-01 myprog-02 myprog-03 myprog-04 

1 3 myprog-01 : file-001 .o file-002.o . . . file-025.o 

14 myprog-02: file-026.o file-027.o ... file-OSO.o 

1 5 myprog-03: file-051 .o file-052.o . . . file-075.o 

1 6 myprog-04: file-076.o file-077.o . . . file-1 OO.o 

17 # now parallel commands can be issued against parallel targets 

18 # running on multiple machines 

19 on machinel : make myprog-01 

20 on machine2: make myprog-02 



21 
22 
23 
24 
25 
26 
27 
28 
29 



# or running in the background on one machine 
in shell window 1: make myprog-01 & 
in shell window 1 : make myprog-02 & 



# running multiple windows on one machine 
in shell window 1: make myprog-01 
in shell window 2: make myprog-02 



40/41 



FIG. 63 



1 action-c-source.tpl: 

2 # process files 

3 ... 

4 # this line adds the parallelism-specific object file macro to the 

5 # "master" or "top level" object file macro. 

6 fragment-begin 

7 _macro_ OBJ_PI prod_ append $(OBJ_PI prod zplnj) 

8 fragment-end 
9 

10 # this line adds current object file to correct 

1 1 # parallelism-specific object file macro 

12 fragment-begin 

1 3 _macro_ OBJ_PI prod ^zpln_ append Jarget_name_$(0) 

14 fragment-end 
15 

16 # this line adds the parallelism-specific object file macro as a 

1 7 # dependency of the parallelism-specific build target. 

18 fragment-begin 

1 9 Jarget_ build zpin_ add_deps $(OBJ_PI prod ^zpln J 

20 fragment-end 



1 makefile. out: 

2 ... 

3 OBJ_PLmyprog = file-001.o file-002.o ... file-IOO.o 

4 OBJ_PLmyprog_01 = file-OOlo file-002.o ... file-025.o 

5 OBJ_PLmyprog_02 = file-026.o file-027.o ... file-050.o 

6 ... 



FIG. 64 



7 
8 
9 
10 



build_01 : $(OBJ_PI_myprog_01 ) 



build_02: $(OBJ_PLmyprog_02) 
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FIG. 65 

1 makefile.out: 

2 # sequential and parallel targets for multiple products 

3 ... 

4 # target for building all products sequentially 

5 build: build_01 build_02 build_03 

6 ... 

7 # parallel targets for building all products in parallel 

8 build_01: myprog-01 product2-01 product3-01 ... 

9 build_02: myprog-02 product2-02 product3-02 ... 

10 ... 

1 1 # target for building product *myprog' sequentially 

12 myprog: myprog-01 myprog-02 myprog-03 

13 ... 

14 # parallel targets for building product 'myprog' in parallel 

1 5 myprog-01 : $(OBJ_PLmyprog_01 ) 

16 myprog-02: $(OBJ_PI_myprog_02) 

17 ... 

18 # target for building product 'product2' sequentially 

19 product2: product2-01 product2-02 ... 

20 ... 

21 # parallel targets for building product 'product2' in parallel 

22 product2-01 : $(OBJ_PLproduct2_01 ) 

23 product2-02: $(OBJ_PLproduct2_02) 



